home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dirut / l11.zip / README.TXT < prev   
Text File  |  1993-05-06  |  30KB  |  674 lines
  1.  
  2.  
  3.         ######  #     # #######   ###   #        #####          #
  4.         #     # #     #    #       #    #       #     #         #    #
  5.         #     # #     #    #       #    #       #               #    #
  6.         ######  #     #    #       #    #        #####          #    #
  7.         #   #   #     #    #       #    #             #         #######
  8.         #    #  #     #    #       #    #       #     #              #
  9.         #     #  #####     #      ###   #######  #####               #
  10.  
  11.                       (freeware)
  12.  
  13.  
  14.             Contents
  15.             --------
  16.             1  Introduction
  17.                         2  Legal stuff
  18.             3  What is available?
  19.             4  Technical notes
  20.             5  The user interface
  21.             6  Source code availability
  22.             7  Credits
  23.             8  Revision history
  24.             9  How to contact me
  25.  
  26.  
  27. 1  Introduction
  28. ---------------
  29. This software is a part of version 4 of Rickis little useful (?) DOS utilities.
  30. After version 3 I decided to split them up and distribute the stuff in smaller
  31. packages (mainly because the file became too big). If you have comments or
  32. suggestions, please contact me. You find my address at the end of this
  33. document.
  34.  
  35. All programs were programmed with Turbo Pascal 6.0 on a 286 AT compatible
  36. machine using Norbert Juffas TURBO.TPL replacement, version TPL60N19. Each of
  37. them is tested to a reasonable level of stability (I use them myself :-) ). If
  38. you have problems, please contact me. I suppose you need at least DOS 3.x to
  39. run everything successfully. RUTILS ran without problems on the following
  40. platforms:
  41.  
  42.                 Original IBM AT 286, MS-DOS 3.3
  43.                 AT 286-20 NEAT, AMI Bios, MS-DOS 3.3
  44.                 AT 286-20 NEAT, AMI Bios, MS-DOS 5.0
  45.                 AT 286-20 NEAT, AMI Bios, DR-DOS 6.0
  46.                 AT 386 NEAT, AMI Bios (10/89), MS-DOS 5.0
  47.                 AT 486, AMI Bios, MS-DOS 5.0
  48.  
  49. After RUTILS3 was out, several people kindly reported some bugs to me. There
  50. were some which could be fixed immediately. One bug, however, was a bit harder
  51. to find. Some debug sessions later I found that DR-DOS and MS-DOS are not as
  52. compatible as they should be. This version has been tested with both MS-DOS and
  53. DR-DOS. None of my TSRs caused any problems.
  54.  
  55. On PCs with a 80486 chip, it may happen that one of the programs crashes. This
  56. has nothing to do with my software (at least I hope so :-)). The effect is that
  57. the PC hangs and must be rebooted. If you start the program in a Windows DOS
  58. box, a weird error message is displayed and the computer must be rebooted. If
  59. you use the DOS DEBUG command to start the program, everything runs fine. What
  60. makes me think that the problem has nothing to do with my software is the fact
  61. that (a) I can fix the bug by simply adding some few bytes to the executable
  62. (eg. by placing some additional spaces in a help screen) and (b) it occured
  63. that a program crashed if it had been DIETed, and ran without being compressed
  64. and for another program this behaviour could be observed in the opposite way.
  65. If anyone has more information about that strange matter, please contact me.
  66.  
  67. The RUTILS package is intended for people who already have the basic knowledge
  68. about DOS. You should know how to view and modify text files (if you read this,
  69. you appearently know how to view them :-) ), how to redirect a programs output
  70. to a file (and how to append it to the target file) and how to use the pipe
  71. symbol '|'. I did not include a complete introduction to DOS in every DOC file.
  72. For DCAT you must know how to put labels on diskettes, for ASET you must know
  73. what shell variables are (and how to view and modify them), GENOUT will only be
  74. useful if you program in a shell or in a programming language, and CHMOD
  75. requires some knowledge about file attributes.
  76.  
  77. All the programs are a result of my hobby, not my profession.
  78.  
  79.  
  80. 2  Legal stuff
  81. --------------
  82. You are free to use this software if it is not modified in any way and if you
  83. give it away for free. You may only charge a minimal fee to cover distribution
  84. or diskette costs. The author disclaims all warranties as to this software,
  85. whether express or implied, including without limitation any implied warranties
  86. of merchantability, fitness for a particular purpose, functionality or data
  87. integrity or protection. Phew.
  88.  
  89. For magazines, software distributors, sysops, ftp site administrators...
  90. ------------------------------------------------------------------------
  91. If you spread the RUTILS4 software by placing it on a ftp site for public
  92. access, or putting it on a diskette for a computer magazine, or making it
  93. available in any other way for a large user group, you *must* inform me by
  94. email (preferred) or mail. This will allow me to inform you if any substantial
  95. modifications have been made since you got the package, and let me have an
  96. overview on how the software has been spread. You don't have to register. You
  97. don't have to pay. You only have to tell me.
  98.  
  99.  
  100. 3  What is available?
  101. ---------------------
  102. The following table gives an overview over what's available and into which
  103. categories it falls. Some of the programs are marked with (unix) to show that
  104. they are (at least) similar to Unix commands.
  105.  
  106. +-----------------------------------------------------------------------------+
  107. |                  Text file utilities                  |
  108. +---+---------+---------------------------------------------------------------+
  109. | 1 | CUT     | Remove selected fields from each line of a file (unix)        |
  110. | 1 | DETAB   | Change tabs to spaces in several files (unix: expand)         |
  111. | 1 | ENTAB   | Change spaces to tabs in several files (unix: unexpand)       |
  112. | 1 | FMT     | ASCII text formatter (unix)                                   |
  113. | 1 | HEAD    | Show the first lines of a file (unix)                         |
  114. | 1 | LOCASE  | Change chars in several files from upper to lower case        |
  115. | 1 | MCOL    | Arrange text in multiple columns                              |
  116. | 1 | NODUP   | Remove successive equal lines from files                      |
  117. | 1 | TAIL    | Show the last lines of a file (unix)                          |
  118. | 1 | UPCASE  | Change chars in several files from lower to upper case        |
  119. | 1 | WC      | Count words, lines, and chars of several text files (unix)    |
  120. +---+---------+---------------------------------------------------------------+
  121. |               Arbitrary file utilities                  |
  122. +---+---------+---------------------------------------------------------------+
  123. | 2 | CAT     | Append several outputs to stdout (unix)                    |
  124. | 3 | FILE    | File type guesser (unix)                                    |
  125. | 2 | HD      | Display hex dumps of several files                               |
  126. | 2 | STRINGS | Find printable strings in an object file or binary (unix)     |
  127. | 2 | TEE     | Duplicate textual output to a file (unix)                   |
  128. +---+---------+---------------------------------------------------------------+
  129. |                     Directory utilities                  |
  130. +---+---------+---------------------------------------------------------------+
  131. | 4 | L       | Display information about files and directories                |
  132. +---+---------+---------------------------------------------------------------+
  133. |                    Programming utilities                  |
  134. +---+---------+---------------------------------------------------------------+
  135. | 5 | GENOUT  | Generate program fragments for textual output                 |
  136. +---+---------+---------------------------------------------------------------+
  137. |                           Batch file utilities                              |
  138. +---+---------+---------------------------------------------------------------+
  139. | 6 | ASET    | Enhanced SET command                                          |
  140. +---+---------+---------------------------------------------------------------+
  141. |                   Miscellanous utilities                  |
  142. +---+---------+---------------------------------------------------------------+
  143. | 5 | BANNER  | Display strings in huge letters (unix)                        |
  144. | 5 | CAL     | Display a calendar (unix)                                     |
  145. | 5 |